home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 25 / CU Amiga Magazine's Super CD-ROM 25 (1998)(EMAP Images)(GB)(Track 1 of 2)[!][issue 1998-08].iso / CUCD / Programming / ixemul / doc / INSTALL < prev    next >
Encoding:
Text File  |  1998-04-18  |  6.5 KB  |  183 lines
  1.  
  2.             IXEMUL  LIBRARY  INSTALLATION  NOTES
  3.  
  4.                (last updated 27-May-97)
  5.  
  6.  
  7. =====================
  8. DISTRIBUTION CONTENTS
  9. =====================
  10.  
  11. The net ixemul library distribution consists of several archives:
  12.  
  13.   ixemul-bin.lha    Utils for gg/bin, like ixtrace and ixprefs
  14.  
  15.   ixemul-sdk.lha    Files needed to build applications that use
  16.             ixemul.library.
  17.  
  18.   ixemul-doc.lha    Various documentation, such as this file
  19.  
  20.   ixemul-src.tgz    Complete source code for ixemul library as
  21.             a gzip compressed tar archive.
  22.  
  23.   ixemul-tz.lha        Pieces for doing TZ (timezone) management
  24.  
  25.   ixemul-CCCF.lha    Specific flavors of the library, where 'CCC'
  26.             is one of 000, 020, or 040, for 68000, 68020,
  27.             and 68040 respectively, and 'F' is either
  28.             'f', 's', or 't' for FPU support or soft floating
  29.             point or a "trace" version (also soft float)
  30.             respectively.
  31.  
  32. The ixemul-doc.lha archive contains various readme and copyright files that
  33. do not need to be installed anywhere.  The ixemul-src.tgz archive contains
  34. the source tree that can be installed anywhere.  The rest of the archives
  35. should simply be extracted relative to the gg: directory to put all the
  36. files in their standard location.
  37.  
  38. ========================
  39. INSTALLING RUNTIME FILES
  40. ========================
  41.  
  42. For the moment, you must manually install the files.  Eventually there will
  43. be an installer script available that you can use with the standard AmigaOS
  44. installer program to make installation more WorkBench friendly.
  45.  
  46. First backup any files in gg: that will get overwritten during the install,
  47. if you wish to preserve them.  These files typically are:
  48.  
  49.     gg:bin/ixprefs
  50.     gg:bin/ixtrace
  51.     gg:bin/ixstack
  52.     gg:lib/bcrt0.o
  53.     gg:lib/crt0.o
  54.     gg:lib/rcrt0.o
  55.     gg:lib/libc.a
  56.     gg:lib/libb/libc.a
  57.     gg:include        (lots of files, but probably not all)
  58.     gg:man            (lots of files, but probably not all)
  59.     gg:etc            (lots of files, but probably not all)
  60.     gg:Sys/libs/ixemul*    (all the old versions of the library)
  61.  
  62. Change directory to gg: and extract the contents of ixemul-bin.lha,
  63. ixemul-sdk.lha (if you expect to be building any ixemul.library using
  64. applications), ixemul-tz.lha (optional) and any ixemul-XXXX.lha archives
  65. that you want, overwriting any existing copies of the files in your Geek
  66. Gadgets tree.  For example, to install the utils, sdk, and both the 68000
  67. 68040+68881 versions of the library, do the following:
  68.  
  69.     lha -mraxe x ixemul-bin.lha gg:
  70.     lha -mraxe x ixemul-sdk.lha gg:
  71.     lha -mraxe x ixemul-000.lha gg:
  72.     lha -mraxe x ixemul-040f.lha gg:
  73.  
  74. Now you need to decide which version of the library to use, based on what
  75. sort of machine you have (68000, 68020 or 68030, 68040) and whether or not it
  76. has an FPU (68020+68881, 68030 with FPU, or 68040 with FPU).  Do something
  77. like the following:
  78.  
  79.     cd gg:Sys/libs
  80.     copy ixemul040fpu.library ixemul.library clone
  81.  
  82. Then either reboot or run a program to flush the existing ixemul.library (if
  83. any) from memory.  You should also review the NEWS file from the docs
  84. archive for changes made since the version from which you have upgraded.
  85. If you installed the ixemul-tz.lha archive you should read ixtimezone.doc
  86. from the docs archive and set your TZ environment variable appropriately.
  87.  
  88. =======================
  89. INSTALLING SOURCE FILES
  90. =======================
  91.  
  92. To extract the source code, simply cd to a directory where you would like
  93. the source code directory to be created, and extract the source archive
  94. there:
  95.  
  96.     cd gg-src:
  97.     gzip -d ixemul-src.tgz
  98.     tar -xvf ixemul-src.tar
  99.     rm ixemul-src.tar
  100.  
  101. Note that this will create the directory ixemul and populate it with all the
  102. source files.
  103.  
  104. To rebuild the library, all that is needed is to run the configure script
  105. and then run make.  It is recommended that you use separate source and build
  106. directories so you can leave the source tree untouched:
  107.  
  108.     cd gg-build:
  109.     makedir ixemul
  110.     cd ixemul
  111.     sh /gg-src/ixemul/configure --prefix=/gg
  112.  
  113. This will create a Makefile and several subdirectories with other Makefiles.
  114. Note the section in the Makefile that looks like:
  115.  
  116. ###  CPU-FPU types.
  117. ###
  118. ###  The default thing to do is to make all reasonable combinations of the
  119. ###  library.
  120. ###
  121. ###  Note that libsrc, which builds the runtime startup files and all
  122. ###  versions of libc.a, and utils completely ignore the base/cpu/fpu variables,
  123. ###  so these are handled in the all: target.
  124. ###
  125. ###  You can remove specific CPU/FPU combinations that you are not interested in.
  126.  
  127. CPU-FPU-TYPES =    68000.soft-float \
  128.         68020.soft-float 68020.68881 \
  129.         68040.soft-float 68040.68881
  130.  
  131. By default, all of the versions of ixemul.library are built by make.  This
  132. can take a relatively long time.  If you only want to build one particular
  133. version of the library and runtime files to test, just remove the lines
  134. you don't want.  I.E.  to build a 68040+68881 version, the above lines
  135. should be changed to:
  136.  
  137. CPU-FPU-TYPES =    68040.68881
  138.  
  139. Then just run "make" in the build directory:
  140.  
  141.     cd gg-build:ixemul
  142.     make
  143.  
  144. Note that you must have a version of GNU make that is newer than the ones
  145. distributed on the FreshFish CDs and on aminet.  Those makes had a patch for
  146. AmigaOS that nobody used but disabled an important feature that the current
  147. ixemul Makefiles use.  If you have problem compiling the ixemul library get
  148. the latest Geek Gadgets make from ftp.ninemoons.com:pub/geekgadgets or a
  149. mirror.
  150.  
  151. You need at least version 2.6.0 of gas, the GNU assembler. Earlier
  152. versions didn't fully support the Motorola assembly syntax, but this one
  153. does. Again, you can get this from Geek Gadgets.
  154.  
  155. You also need a gcc that accepts the -mrestore-a4 and the -resident32
  156. option (first released in November/December 1996), otherwise ixemul will
  157. not compile.
  158.  
  159. Finally, if you have an older version of ixemul.library installed while you
  160. are compiling this new version, then you may run into trouble building the
  161. timezone files using the 'zic' utility. This utility requires the latest
  162. ixemul.library (which you have just compiled), but since you haven't
  163. installed it yet, zic complains that the ixemul.library is too old. The
  164. solution is to install the new ixemul.library first, and then continue
  165. compiling. You may have to use 'avail flush' or reboot after installing the
  166. new library to insure that the old library is really flushed from memory.
  167.  
  168. =======
  169. IXPREFS
  170. =======
  171.  
  172. Note that effective with ixemul.library 42.0, ixconfig can no longer be
  173. used.  Use ixprefs instead.
  174.  
  175. ==============
  176. REPORTING BUGS
  177. ==============
  178.  
  179. Please report problems or bugs to Hans Verkuil (hans@wyst.hobby.nl), who is
  180. the current ixemul library coordinator.  Even better than a bug report is a
  181. bug fix, which typically would be a context diff file for one or more ixemul
  182. source files.
  183.